Release 10.1A: OpenEdge Development:
Progress Dynamics Managers API Reference

getTranslation

This procedure checks if any translations exist for the passed-in details.

If a language is not passed in, the procedure uses the specified login language. If the object passed in is a specific object, the procedure first looks for a translation for that specific object. If none exists, it looks for a translation for all objects (blank object name). The procedure can handle title, browse, fill-in, radio set, text, button, toggle box, combo box, slider, and editor widgets.

Location: af\app\aftrnmngrp.i

Parameters:

INPUT pdLanguageObj AS DECIMAL

The language object number, or 0 for the login language.

INPUT pcObjectName AS CHARACTER

The object name for which to get the translation, or blank for all.

INPUT pcWidgetType AS CHARACTER

The widget type.

INPUT pcWidgetName AS CHARACTER

The widget name (LABEL) or, if it is a text widget, the text to translate.

INPUT pcWidgetEntry AS INTEGER

The widget entry, used for radio sets and similar widgets

OUTPUT pcOriginalLabel AS CHARACTER

The original untranslated label.

OUTPUT pcTranslatedLabel AS CHARACTER

The translated label.

OUTPUT pcOriginalTooltip AS CHARACTER

The original untranslated ToolTip.

OUTPUT pcTranslatedTooltip AS CHARACTER

The translated ToolTip.

Notes:

A window title translation is a special case that uses “title” as the value for both widget type and widget name.
Column label translations use a widget type of “browse” and a widget name of the column label.
ToolTip translations are ignored for text widgets.
For a procedure running client-side, if the cachedTranslationsOnly property is set to YES in the Session Manager, then the database is not checked for translations that are not in the cache.
Examples: See the translatePhrase function in af\app\aftrnmngrp.i.